home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / pc / files / vhf / contest.lzh / MANUAL.DOC < prev   
Text File  |  1988-02-08  |  43KB  |  1,388 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                  USERS MANUAL
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                  ccccc       ooooo       nn    n     ttttttt
  33.                c     c     o     o      n n   n        t
  34.               c           o     o      n  n  n        t        E
  35.              c     c     o     o      n   n n        t           S
  36.              ccccc       ooooo       n    nn        t              T
  37.  
  38.  
  39.  
  40.  
  41.  
  42.              version 2.10                    (C)Copyright 1987,1988
  43.                                              O.R. le Grand, PE1HRB
  44.                                              Delft - the Netherlands
  45.  
  46.  
  47.  
  48.  
  49.  
  50.      TABLE OF CONTENTS.
  51.  
  52.      1 INTRODUCTION TO CONTest.  . . . . . . . . . . . . . . . . . . .    3
  53.           1.1 FILES ON YOUR DISK.  . . . . . . . . . . . . . . . . . .    4
  54.           1.2 REQUIRED EQUIPMENT.  . . . . . . . . . . . . . . . . . .    4
  55.  
  56.      2 STARTING THE CONTest PROGRAM. . . . . . . . . . . . . . . . . .    5
  57.  
  58.      3 THE STATUS LINE.  . . . . . . . . . . . . . . . . . . . . . . .    7
  59.  
  60.      4 THE MAIN MENU.  . . . . . . . . . . . . . . . . . . . . . . . .    7
  61.  
  62.      5 THE ONLINE MODE.  . . . . . . . . . . . . . . . . . . . . . . .    8
  63.           5.1 AUTOMATIC INPUT. . . . . . . . . . . . . . . . . . . . .    9
  64.           5.2 MANUAL INPUT.  . . . . . . . . . . . . . . . . . . . . .   10
  65.           5.3 COMMANDS AVAILABLE IN ONLINE MODE. . . . . . . . . . . .   11
  66.  
  67.      6 THE EDIT MODE.  . . . . . . . . . . . . . . . . . . . . . . . .   13
  68.  
  69.      7 CREATING LOGFILES.  . . . . . . . . . . . . . . . . . . . . . .   14
  70.  
  71.      8 THE MERGEFILE.  . . . . . . . . . . . . . . . . . . . . . . . .   16
  72.           8.1 HOW DOES IT WORK ? . . . . . . . . . . . . . . . . . . .   16
  73.           8.2 THE <D> COMMAND. . . . . . . . . . . . . . . . . . . . .   18
  74.           8.3 THE <SC> AND <SQ> COMMANDS.  . . . . . . . . . . . . . .   18
  75.           8.4 CREATING A NEW MERGEFILE.  . . . . . . . . . . . . . . .   18
  76.  
  77.      9 RECORD FORMATS. . . . . . . . . . . . . . . . . . . . . . . . .   20
  78.           9.1 THE RECORD FORMAT OF THE DATAFILE. . . . . . . . . . . .   20
  79.           9.2 THE RECORD FORMAT OF THE MERGEFILE.  . . . . . . . . . .   20
  80.           9.3 THE RECORD FORMAT OF THE COVERSHEETFILE. . . . . . . . .   21
  81.           9.4 FORMATS OF OTHER FILES.  . . . . . . . . . . . . . . . .   21
  82.  
  83.      10 INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . .   22
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.                              CONTest users manual
  106.                                     page 2.
  107.  
  108.  
  109.  
  110.  
  111.      1 INTRODUCTION TO CONTest.
  112.  
  113.      The  program  CONTest  was  written  to use in the vhf/uhf/shf contest
  114.      during the  season  '86/'87  which  I  joined  with  the contest-group
  115.      PE1DCY/P.
  116.      The goal  was to  develop a  program that was usable during real-world
  117.      conditions. The characteristic features of CONTest  are the  so called
  118.      "automatic  input"  which  makes  it  possible  to enter the data of a
  119.      station in an arbitrary  order  and  the  fact  that  the  program can
  120.      recognize a  call even if the station is /p /a etc. (this is a must to
  121.      check for dupe : e.g. the program recognizes  that the  call pe1hrb is
  122.      the same call as hb/pe1hrb/p)
  123.  
  124.      The program has been implemented in the TURBO pascal language.
  125.      In previous  versions of the program the user interface used the Dutch
  126.      language. From now on (version  2.10)  the  English  (or  a "familiar"
  127.      h.i.) language is used.
  128.  
  129.      However the  program has been used during more than a season, both the
  130.      program and the manual can not be perfect (and contain  errors ==> see
  131.      Murphy).  Therefore  I  accept  no  responsibility for the use of this
  132.      program.
  133.  
  134.      When you have any  questions about  the CONTest  program, or  when you
  135.      found one of the errors, please write !
  136.  
  137.      My mailing address is :
  138.  
  139.      Otto le Grand, PE1HRB
  140.      Heimanslaan 5
  141.      6705 AD  Wageningen
  142.      the Netherlands
  143.      tel. 08370 14618
  144.  
  145.  
  146.  
  147.      Hope you enjoy it, good luck in the contest !
  148.  
  149.      73' Otto.
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.                              CONTest users manual
  167.                                     page 3.
  168.  
  169.  
  170.  
  171.  
  172.      1.1 FILES ON YOUR DISK.
  173.  
  174.      The following files should be present on the disk :
  175.           1)   contest.com    -    The main program.
  176.           2)   contest.msg    -    The helpfile for CONTest.
  177.           3)   contmrg.com    -    Program to create new mergefiles.
  178.           4)   mf.mrg         -    A mergefile.
  179.           5)   manual.doc     -    This file.
  180.  
  181.  
  182.  
  183.      1.2 REQUIRED EQUIPMENT.
  184.  
  185.      The CONTest  program needs an IBM (compatible) PC with a PC-DOS or MS-
  186.      DOS operating system version 2.11 or higher. The required memory space
  187.      is :
  188.           1)   memory used by your operating system +
  189.           2)   memory used by contest.com +
  190.           3)   73 bytes for each logged qso +
  191.           4)   36 bytes for each merge-station in memory +
  192.           5)   memory in use by other programs.
  193.  
  194.      Every qso logged on disk contains 73 bytes.
  195.  
  196.  
  197.  
  198.      remarks : 1)   Turbo  Pascal  is  a  registered  trademark  of Borland
  199.                     international inc.
  200.                2)   IBM and PC-DOS are registered trademarks of Internatio-
  201.                     nal Business Machines Corp.
  202.                3)   MS-DOS is a trademark of Microsoft Corp.
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.                              CONTest users manual
  228.                                     page 4.
  229.  
  230.  
  231.  
  232.  
  233.      2 STARTING THE CONTest PROGRAM.
  234.  
  235.      After starting  the program  from DOS the following data must be ente-
  236.      red :
  237.  
  238.      GMT            :    You have to  enter  the  number  of  hours  to GMT
  239.                          here. i.e.  the difference  between local time and
  240.                          GMT.
  241.                          e.g.1 :   Your system-time is 12.00
  242.                                    The GMT is 10.00
  243.                                    --> You enter "2"
  244.                          e.g.2 :   Your system-time is 10.00
  245.                                    The GMT is 12.00
  246.                                    --> You enter "-2"
  247.  
  248.      QTH-LOCATOR    :    You have to enter your own  qth locator.  Both the
  249.                          new and the "old" qth locator are supported. 
  250.  
  251.      NUMBER OF
  252.           BANDS     :    Here you  have to specify the number of bands that
  253.                          you want to log on your pc. The  maximum number of
  254.                          bands that can be logged on one pc is 8.
  255.  
  256.      NAMES OF
  257.      DATAFILES      :    You must  now specify  the names of all your data-
  258.                          files.
  259.                          The file-extension is always .DAT even  if another
  260.                          extension has  been specified.  It is not possible
  261.                          to enter a filename twice. The maximum length of a
  262.                          filename is  5 characters (without the extension).
  263.                          Beware : some filenames  as  con,lst,prn  etc. can
  264.                          cause problems.
  265.                          If  a  file  exists  the  data is read into memory
  266.                          otherwise a new file is created.
  267.  
  268.      MERGEFILE      :    CONTest  has  the  option  of  using  a  so called
  269.                          "merge-file".  The   mergefile  contains  data  of
  270.                          station worked in previous contests.
  271.                          The file-extension of a mergefile is .MRG, even if
  272.                          an other  extension has been specified. If the use
  273.                          of a mergefile is desired the name of the file has
  274.                          to be  specified now.  If the file exists the data
  275.                          is read into memory. If the use of  a mergefile is
  276.                          not desired just press <RETURN>.
  277.  
  278.  
  279.      Now  the  data  of  all  the  specified  files are read into memory. A
  280.      counter counts the number of qso's that has be read from the  file. As
  281.      soon as  the files  have been  read you  are confronted  with the main
  282.      menu.
  283.  
  284.  
  285.  
  286.  
  287.  
  288.                              CONTest users manual
  289.                                     page 5.
  290.  
  291.  
  292.  
  293.  
  294.      remarks : 1)   It's practical to choose the names of the  datafiles in
  295.                     accordance with  the wave-length of the bands which are
  296.                     logged e.g. 23.DAT for  twenty-three centimeters, 2.DAT
  297.                     for two meters etc.
  298.                2)   If you  want to continue with existing data, just enter
  299.                     the filename. the program  automatically continues with
  300.                     the old data.
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.                              CONTest users manual
  350.                                     page 6.
  351.  
  352.  
  353.  
  354.  
  355.      3 THE STATUS LINE.
  356.  
  357.      On top  of your  screen you see the status line in reverse video. This
  358.      line is shown in all menus, the online and the edit mode.
  359.      From left to right you see :  1)   The name of the mode.
  360.                                    2)   The  total  distance  of  all qso's
  361.                                         added together (points).
  362.                                    3)   The average distance.
  363.                                    4)   The  filename  which  is  currently
  364.                                         active. To this file  the qso's are
  365.                                         written   after   they   have  been
  366.                                         completed.
  367.  
  368.  
  369.  
  370.      4 THE MAIN MENU.
  371.  
  372.      You can choose between :
  373.  
  374.           Online         :    After typing the <O>  command you  are in the
  375.                               online mode.  This is  the mode  in which you
  376.                               add new qso's to a certain band.
  377.                               From this mode it is also  possible to  go to
  378.                               the edit  mode and  to give  some useful com-
  379.                               mands.
  380.  
  381.           Logfiles       :    After typing the <L> command you  move to the
  382.                               logfiles menu.  In the  logfiles menu you can
  383.                               create outputfiles to print.
  384.  
  385.           Next band      :    When you specified two  or more  bands to use
  386.                               on this  pc, the <N> command moves you to the
  387.                               next band. The band which is currently active
  388.                               is shown in the status line.
  389.  
  390.           Previous band  :    When you  specified two  or more bands to use
  391.                               on this pc, the <P> command moves you  to the
  392.                               previous  band.  The  band which is currently
  393.                               active is shown in the status line.
  394.  
  395.           Exit program   :    After typing <ESC> you  have to  confirm your
  396.                               choice to exit the CONTest program.
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.                              CONTest users manual
  411.                                     page 7.
  412.  
  413.  
  414.  
  415.  
  416.      5 THE ONLINE MODE.
  417.  
  418.      The online  mode is  the normal  mode for  this program.  Here you add
  419.      qso's to a band, edit them and can give some commands.
  420.      Left of the prompt  the qso  number (serial  number) is  shown. In the
  421.      status line  and as a part of the prompt you see the band on which the
  422.      qso's are logged.
  423.  
  424.      There are two ways of logging a qso in the online mode :
  425.           1)   Automatic input.
  426.                This is the common way of  logging. Under  normal conditions
  427.                this is the only way of logging you will need.
  428.           2)   Manual input.
  429.                This can  be useful  to force  certain data into the program
  430.                when it's not accepted or wrong interpreted in the automatic
  431.                mode.
  432.  
  433.  
  434.  
  435.      remarks : 1)   Both  methods  can  be  used  during  one  qso. So it's
  436.                     possible to log some  items of  a qso  in the automatic
  437.                     input mode and the rest in the manual input mode.
  438.                2)   Every qso  is saved  on disk directly when all data has
  439.                     been logged. In case of a power break no data is lost.
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.                              CONTest users manual
  472.                                     page 8.
  473.  
  474.  
  475.  
  476.  
  477.      5.1 AUTOMATIC INPUT.
  478.  
  479.      What an easy way to log a qso !!
  480.      The only  thing you  have to  do is  to enter  an item  that should be
  481.      logged. In this way it is possible to log :
  482.           1)   A call.
  483.           2)   A sent report.
  484.           3)   A received report.
  485.           4)   A qth locator.
  486.  
  487.      Enter :   <data>
  488.  
  489.      After  an  item  has  been  entered the program responds which type of
  490.      input has been recognized. As you see : the order of logging  the four
  491.      items of a qso is irrelevant.
  492.      A qso  is completed when all four items as mentioned above are logged.
  493.      As long as not all the  items are  logged it  is possible  to enter an
  494.      item again  if it has to be corrected. The last entered item is retai-
  495.      ned. When a call is entered the program automatically searches whether
  496.      this station  is worked  before. Strokes  are ignored when the program
  497.      searches for dupe. e.g. pe1hrb is the same call as hb/pe1hrb/p when it
  498.      checks.
  499.  
  500.  
  501.  
  502.      remarks : 1)   A  sent  report  has  to  be entered without the serial
  503.                     number. This number is logged automatically.
  504.                2)   The rules the program uses to recognize the  four items
  505.                     of a qso are :
  506.                          1)   The entered  data not  recognized as anything
  507.                               else is a call.
  508.                          2)   Data which contain  only  numbers  and  has a
  509.                               maximum  length  of  3  characters  is a sent
  510.                               report.
  511.                          3)   Data which contain  only  numbers  and  has a
  512.                               length of  more than 3 characters is a recei-
  513.                               ved report.
  514.                          4)   Data  that  starts   with   two  alphabetical
  515.                               characters, followed by two numbers, followed
  516.                               by one or two  alphabetical  characters  is a
  517.                               qth locator.
  518.                3)   The GMT and distance are logged automatically.
  519.                4)   It is not possible to log a call twice.
  520.                5)   The maximum input length is 14.
  521.  
  522.  
  523.  
  524.      e.g.1 :   001  filename > 59
  525.                     filename > cl09a
  526.                     filename > 55001
  527.                     filename > pe1hrb/a
  528.  
  529.  
  530.  
  531.  
  532.                              CONTest users manual
  533.                                     page 9.
  534.  
  535.  
  536.  
  537.  
  538.      5.2 MANUAL INPUT.
  539.  
  540.      If the  CONTest program  recognizes the  entered data not correctly in
  541.      the automatic input mode,  it's possible  to force  the data  into the
  542.      program. This is done as shown below.
  543.  
  544.      Enter :   <input character> <blank> <data>
  545.  
  546.      The four input characters are :
  547.           <C>  :    To enter a call.
  548.           <S>  :    To enter a sent report.
  549.           <R>  :    To enter a received report.
  550.           <Q>  :    To enter a qth(locator).
  551.  
  552.      When data  is logged  in this way no checks are performed on the data,
  553.      except on the call which still has to be unique. So now  it's possible
  554.      to enter "London" as qth and 59a as a report. ATTENTION : The distance
  555.      is set to zero when a qth is logged in this way.
  556.  
  557.  
  558.  
  559.      remarks : 1)   When a qth is logged the distance is set to zero.
  560.                2)   All data after the blank is logged.
  561.                3)   When the entered data is too long an error occurs.
  562.                4)   The order of logging the items is irrelevant.
  563.  
  564.  
  565.  
  566.      e.g.1 :   001  filename > c pe1hrb/a
  567.                     filename > s 59a
  568.                     filename > r 57a001
  569.                     filename > q delft
  570.  
  571.      e.g.2 :   002  filename > q cl09a
  572.                     filename > s 59a
  573.                     filename > r strong
  574.                     filename > c pe1dcy/p
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.                              CONTest users manual
  594.                                    page 10.
  595.  
  596.  
  597.  
  598.  
  599.      5.3 COMMANDS AVAILABLE IN ONLINE MODE.
  600.  
  601.      In the online mode you can give some  commands to  get special effects
  602.      or to edit a particular qso.
  603.  
  604.      Enter :   <command>
  605.  
  606.      Following commands are available in online mode :
  607.  
  608.      <E>       :    Edit  a  qso.  After  the  command is given the program
  609.                     asks to enter the call or the serial number of  the qso
  610.                     that you want to edit. If one of these has been entered
  611.                     correctly the program moves to edit  mode. Now  you can
  612.                     edit following items :
  613.                          1)   The call.
  614.                          2)   The sent report.
  615.                          3)   The received report.
  616.                          4)   The qth(locator).
  617.                          5)   remarks field (option).
  618.  
  619.      <L>       :    Edit last completed qso. After the command is given the
  620.                     programs directly moves to edit mode,  editing the last
  621.                     completed  qso.  Now  you  can  edit  the same items as
  622.                     mentioned above by the <E> command.
  623.  
  624.      <CE>      :    Edit all data of a qso. After the command is  given the
  625.                     program asks  to enter the call or the serial number of
  626.                     the qso that you want to edit. In addition to the items
  627.                     you can  edit with  the <C> and the <L> command you can
  628.                     also edit :
  629.                          6)   The distance.
  630.                          7)   Crossband.
  631.                          8)   GMT.
  632.  
  633.      <C>       :    Cancel qso. e.g when you have  entered some  items of a
  634.                     station but you are not able to complete the qso. After
  635.                     the <C> command has been given you can start again with
  636.                     all details  for a  new station.  Just try  to see what
  637.                     happens !
  638.  
  639.      <X>       :    Exit online mode. With the <X>  command you  go back to
  640.                     the main menu.
  641.  
  642.      <N>       :    Next band.  Exactly as  in the  main menu, with the <N>
  643.                     command you go to the next band (if there is  more than
  644.                     one band). In the status line you can see which band is
  645.                     currently active.
  646.  
  647.      <P>       :    Previous band. Exactly as  in the  main menu,  with the
  648.                     <P> command  you go  to the  previous band (if there is
  649.                     more than  one band).  In the  status line  you can see
  650.                     which band is currently active.
  651.  
  652.  
  653.  
  654.                              CONTest users manual
  655.                                    page 11.
  656.  
  657.  
  658.  
  659.  
  660.      <SC>      :    Search for  call in  MergeFile. If there is a mergefile
  661.                     specified this  command  searches  for  a  call  in it.
  662.                     Useful  when  Direct  search  is switched off. For more
  663.                     details see chapter 8 about the use of the mergefile.
  664.  
  665.      <SQ>      :    Search for locator in MergeFile. If there is a mergefi-
  666.                     le specified  this command  searches for  a qth locator
  667.                     in it. Useful when Direct search  is switched  off. For
  668.                     more details  see chapter 8 about the use of the merge-
  669.                     file.
  670.  
  671.      <D>       :    Direct search on/off. With this option  you can specify
  672.                     whether  it  is  desired  that the program searches the
  673.                     mergefile directly for  calls  and  locators.  For more
  674.                     details see chapter 8 about the mergefile.
  675.  
  676.      <DX>      :    Print best dx on screen.
  677.  
  678.      <GMT>     :    Print GMT on screen.
  679.  
  680.      <TIME>    :    Print system-time on screen.
  681.  
  682.      <DATE>    :    Print system-date on screen.
  683.  
  684.      <CLS>     :    Clear screen.
  685.  
  686.      <?>       :    Lists the  helpfile on  your screen. HELP gives you for
  687.                     example a list of all these commands.
  688.  
  689.  
  690.  
  691.      remarks : 1)   A command must also be terminated with a <RETURN>.
  692.                2)   When the current  active  band  is  the  last specified
  693.                     band and the <N> command is given, the program moves to
  694.                     the first band. The opposite happens for the first band
  695.                     and  the  <P>  command  (the programs turns around in a
  696.                     circle).
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.                              CONTest users manual
  716.                                    page 12.
  717.  
  718.  
  719.  
  720.  
  721.      6 THE EDIT MODE.
  722.  
  723.      From the online mode you could go to edit mode by giving  the <E>, <L>
  724.      or the  <CE> command. In case of the <E> and <CE> command you also had
  725.      to give a call or serial number to edit.
  726.      In the edit mode you are able to edit all logged data of a  qso except
  727.      the serial number.
  728.  
  729.      Special key functions in edit mode :
  730.  
  731.      <ARROW> keys   :    With  the  arrow  keys  you can select the data to
  732.                          edit.
  733.  
  734.      <RETURN>       :    Moves the edit-field one  position down.  This has
  735.                          the same result as giving an <DOWN-ARROW>.
  736.  
  737.      <ESC>          :    Pressing <ESC>  leaves the  edit mode ignoring all
  738.                          changes you made in  this  mode.  So  all  data as
  739.                          logged in online mode is still stored.
  740.  
  741.      <END>          :    Pressing the <END> key (often found on the numeri-
  742.                          cal key pad)  you  leave  the  edit  mode  and all
  743.                          changes are saved now.
  744.  
  745.      <INS>          :    The <INS> key switches between insert and overwri-
  746.                          te mode. In the  right corner  of your  screen you
  747.                          see  which  mode  is active. Default the overwrite
  748.                          mode is used.
  749.  
  750.      <DEL>          :    Deletes the character under the cursor.
  751.  
  752.  
  753.      In the edit mode it is possible to force data  into the  program. When
  754.      the type  of data is not in accordance with the field an warning or an
  755.      error occurs. In case  of an  error it  is not  possible to  leave the
  756.      field before the error has been corrected. Again it is not possible to
  757.      log a call twice.
  758.      If you went to edit mode by giving  the <CE>  command you  are able to
  759.      edit a  "crossband" field.  The only possibilities to enter are <Y>es,
  760.      <J>a and <N>o. Default this field  is set  to "N".  when you  set this
  761.      field to "Y" the distance of the qso is divided by two.
  762.  
  763.  
  764.  
  765.      remarks : 1)   When the  edit-field is  positioned at the bottom field
  766.                     and <RETURN> or <ARROW-DOWN> is pressed,  the edit mode
  767.                     is left with save of all changes.
  768.                2)   If an illegal qth locator is logged the distance is set
  769.                     to zero.
  770.                3)   If a qso is specified to be crossband,  the distance is
  771.                     divided by two.
  772.  
  773.  
  774.  
  775.  
  776.                              CONTest users manual
  777.                                    page 13.
  778.  
  779.  
  780.  
  781.  
  782.      7 CREATING LOGFILES.
  783.  
  784.      In the main menu you choose <L>ogfiles.
  785.      Now in the logfiles menu you can choose between :
  786.  
  787.      Alphabetical outputfile  :    To  create  a file sorted alphabetically
  788.                                    on  the  call  of  the  logged stations.
  789.                                    Stations are sorted on the call, so e.g.
  790.                                    hb9/pe1hrb/p is found under "P".
  791.                                    An  alphabetical  outputfile  always has
  792.                                    the extension .ABC. The name of the file
  793.                                    is the same as the name  of the datafile
  794.                                    from which a logfile is created.
  795.  
  796.      Chronological outputfile :    To  create  a  file  with  the  stations
  797.                                    sorted in order of which they  have been
  798.                                    worked.   The  chronological  outputfile
  799.                                    always has the extension  .OUT. The name
  800.                                    of the  file is  the same as the name of
  801.                                    the datafile  from  which  a  logfile is
  802.                                    created.
  803.  
  804.      Display outputfile       :    To display an outputfile just created by
  805.                                    the <A> or <C> choice.
  806.  
  807.      Format outputfile        :    To set the number of qso's on a page and
  808.                                    to set the pagelength.
  809.  
  810.      Print outputfile         :    To print  an outputfile  just created by
  811.                                    the <A> or <C> choice.
  812.  
  813.      Specify coversheet       :    To specify a coversheet.  The coversheet
  814.                                    is the  first page of your log. Here the
  815.                                    name of the first  operator, total score
  816.                                    etc. are  specified. The entered data is
  817.                                    stored in a file  with the  same name as
  818.                                    the corresponding datafile. The extensi-
  819.                                    on of a coversheetfile always is .KOP.
  820.  
  821.      Exit logfiles            :    After typing <ESC> the  logfiles menu is
  822.                                    left and the program returns to the main
  823.                                    menu.
  824.  
  825.  
  826.  
  827.      remarks : 1)   On the data entered to specify  a coversheet  no syntax
  828.                     checks are performed.
  829.                2)   When  The  <D>isplay  or  <P>rint  choice  is  made the
  830.                     program asks you which, the alphabetical or the chrono-
  831.                     logical, file to display/print. If <ESC> is pressed the
  832.                     program returns to the logfiles menu.
  833.                3)   If you choose the  <A> or  <C> command  the program ask
  834.                     you if  you want  a coversheet  above your file. If you
  835.                     want, a coversheetfile must be present on the  disk. If
  836.  
  837.                              CONTest users manual
  838.                                    page 14.
  839.  
  840.  
  841.  
  842.  
  843.                     a  coversheetfile  is  not  present  the  outputfile is
  844.                     created without a coversheet.
  845.                4)   If the total of valid qso's is not  equal to  the total
  846.                     number of  qso's, you  have to modify the coversheet by
  847.                     an editor.
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.                              CONTest users manual
  899.                                    page 15.
  900.  
  901.  
  902.  
  903.  
  904.      8 THE MERGEFILE.
  905.  
  906.      CONTest supports the use of a  so called  "mergefile". This  file con-
  907.      tains information about stations worked in previous contests. The 
  908.      CONTest program can search for some items in this data.
  909.      The advantages of a mergefile are only available in the online mode.
  910.  
  911.  
  912.  
  913.      8.1 HOW DOES IT WORK ?
  914.  
  915.      When you started the CONTest program you could specify the name of the
  916.      mergefile. Remember that a mergefile always has the extension .MRG (On
  917.      the original  disk the  standard mergefile  mf.mrg is present). When a
  918.      file has been  specified  the  data  of  stations  worked  in previous
  919.      contests is read into memory.
  920.      When you  are in  the online mode you can use this data. There are two
  921.      items the program can search for : 1)   A call.
  922.                                         2)   A qth locator.
  923.  
  924.  
  925.      In the online mode :
  926.  
  927.      You enter a call    :    Now the program  searches  in  the mergefile.
  928.                               Two thing happens now :
  929.                               1)   If the  call is in the mergefile all the
  930.                                    data about this call is printed  on your
  931.                                    screen right  of the  entered call. From
  932.                                    left to right you see :
  933.                                    1)   The  call  as  logged  the previous
  934.                                         time.
  935.                                    2)   The  qth   locator  as  logged  the
  936.                                         previous time.
  937.                                    3)   The  bands  the  station  has  been
  938.                                         worked on in the past.
  939.                               2)   On top  of your screen (below the status
  940.                                    line) two extra lines appear.
  941.                                    1)   On the upper line  all calls, which
  942.                                         are in the mergefile, with the same
  943.                                         suffix  as  the  entered  call  are
  944.                                         printed.
  945.                                    2)   On the  lower line  all calls which
  946.                                         are   worked   during   the  actual
  947.                                         contest and  having the same suffix
  948.                                         as the entered call are printed.
  949.  
  950.      You enter a locator :    Now the program searches in the mergefile.
  951.                               On  top  of  your  screen  (below  the status
  952.                               line) two extra lines appear.
  953.                               1)   On the  upper line  all calls, which are
  954.                                    in the  mergefile, whose  qth locator is
  955.                                    the same  as the  locator of the entered
  956.                                    call are printed.
  957.  
  958.  
  959.                              CONTest users manual
  960.                                    page 16.
  961.  
  962.  
  963.  
  964.  
  965.                               2)   On the lower line  all  calls  which are
  966.                                    worked  during  the  actual  contest and
  967.                                    which qth locator  is  the  same  as the
  968.                                    locator of the entered call are printed.
  969.  
  970.  
  971.  
  972.      remarks : 1)   If there  are to many calls to print on the extra lines
  973.                     on top of your screen, some calls are not printed.
  974.                2)   If the program searches on qth locator, it  is possible
  975.                     you miss  some calls  which you  expected to be in that
  976.                     locator. The reason is some rounding  errors in conver-
  977.                     ting the old to the new locator or vice versa.
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.                              CONTest users manual
  1021.                                    page 17.
  1022.  
  1023.  
  1024.  
  1025.  
  1026.      8.2 THE <D> COMMAND.
  1027.  
  1028.      If  the  used  mergefile  is  very large, the response time of CONTest
  1029.      increases. If you find the program to slow as it  is searching  in the
  1030.      mergefile, you  can switch  the search  procedure off. This is done in
  1031.      the online mode by giving the <D> command.  This command  specifies if
  1032.      direct search is switched on/off. After the command has been given the
  1033.      program prints the actual status of this command. To set direct search
  1034.      on again,  just give  the <D> command again. If direct search is swit-
  1035.      ched off the program searches only in the data of the actual contest.
  1036.  
  1037.  
  1038.  
  1039.      8.3 THE <SC> AND <SQ> COMMANDS.
  1040.  
  1041.      To search in the mergefile, if  direct  search  is  switched  off, two
  1042.      commands are available :
  1043.  
  1044.      <SC> :    Search Call.
  1045.                When a  call is specified the program searches in the merge-
  1046.                file. The results are the same as when direct search was on.
  1047.  
  1048.      <SQ> :    Search Qth.
  1049.                When a qth locator is specified the program  searches in the
  1050.                mergefile. The  results are  the same  as when direct search
  1051.                was on
  1052.  
  1053.  
  1054.  
  1055.      8.4 CREATING A NEW MERGEFILE.
  1056.  
  1057.      With the separate program CONTmrg.com you are able  to generate  a new
  1058.      mergefile. There are two possibilities :
  1059.           1)   Create a new mergefile.
  1060.           2)   Add new stations to an existing mergefile.
  1061.  
  1062.      After starting the program from DOS you have to enter :
  1063.  
  1064.      Name DataFile       :    The  Calls  from  this  file are added to the
  1065.                               MergeFile.  The  DataFile   always   has  the
  1066.                               extension .DAT.
  1067.  
  1068.      Band                :    Here you enter the band on which the qso's of
  1069.                               the DataFile  are  made.  If  you  just press
  1070.                               <RETURN>, the  stations are not marked with a
  1071.                               band.
  1072.  
  1073.      Name old MergeFile  :    If  you  want  to  add  the  stations  of the
  1074.                               DataFile to  an existing MergeFile, you enter
  1075.                               the name of this old MergeFile. The extension
  1076.                               always is  .MRG. If  you want to create a new
  1077.                               MergeFile, just press <RETURN>.
  1078.  
  1079.  
  1080.  
  1081.                              CONTest users manual
  1082.                                    page 18.
  1083.  
  1084.  
  1085.  
  1086.  
  1087.      Name new MergeFile  :    To this filename  the  data  is  written. The
  1088.                               extension always is .MRG.
  1089.  
  1090.  
  1091.  
  1092.      remarks : 1)   If a  call is  present in  the DataFile  and in the old
  1093.                     MergeFile,  the  new  MergeFile  contains  the  data of
  1094.                     station as logged in the DataFile (the MergeFile always
  1095.                     contains the latest details). 
  1096.                2)   If the band is 1.5 cm you enter 15 for the band.
  1097.                3)   As e.g. a station in the old mergefile  was only active
  1098.                     on 70 cm, and now the datafile you add to this mergefi-
  1099.                     le is specified to be a 23 cm band datafile, in the new
  1100.                     mergefile the station is "active" on both the 70 and 23
  1101.                     cm band.
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.                              CONTest users manual
  1143.                                    page 19.
  1144.  
  1145.  
  1146.  
  1147.  
  1148.      9 RECORD FORMATS.
  1149.  
  1150.      In this chapter the record formats as used in the  TURBO pascal imple-
  1151.      mentation of CONTest are shown.
  1152.  
  1153.  
  1154.  
  1155.      9.1 THE RECORD FORMAT OF THE DATAFILE.
  1156.  
  1157.      The record format of a .DAT file is shown below :
  1158.  
  1159.      record    tijd       :   string[5];
  1160.                prefix     :   string[4];
  1161.                suffix     :   string[4];
  1162.                strook1    :   string[4];
  1163.                strook2    :   string[7];
  1164.                ontvangen  :   string[7];
  1165.                verzonden  :   string[3];
  1166.                volgnummer :   integer;
  1167.                qth        :   string[6];
  1168.                qrb        :   integer;
  1169.                crossband  :   boolean;
  1170.                commentaar :   string[15];
  1171.                next       :   ^.DAT record;         { a pointer }
  1172.      end;
  1173.  
  1174.  
  1175.  
  1176.      9.2 THE RECORD FORMAT OF THE MERGEFILE.
  1177.  
  1178.      The record format of a .MRG file is shown below :
  1179.  
  1180.      record    prefix  : string[4];
  1181.                suffix  : string[4];
  1182.                strook1 : string[4];
  1183.                strook2 : string[7];
  1184.                qth     : string[6];
  1185.                actief  : integer;
  1186.                next    : ^.MRG record;              { a pointer }
  1187.      end;
  1188.  
  1189.      The field "actief" is coded as followed :
  1190.      When you see the field as a bit field of 8 bits with bit no. 0 the LSB
  1191.      en bit no. 7 the MSB, for each band on which the station is active one
  1192.      bit is set :
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.                              CONTest users manual
  1204.                                    page 20.
  1205.  
  1206.  
  1207.  
  1208.  
  1209.           bit no.        band
  1210.  
  1211.           0              2m
  1212.           1              70cm
  1213.           2              23cm
  1214.           3              13cm
  1215.           4              9cm
  1216.           5              6cm
  1217.           6              3cm
  1218.           7              1.5cm
  1219.  
  1220.  
  1221.  
  1222.      9.3 THE RECORD FORMAT OF THE COVERSHEETFILE.
  1223.  
  1224.      The .KOP file contains strings with a length of 40.
  1225.  
  1226.  
  1227.  
  1228.      9.4 FORMATS OF OTHER FILES.
  1229.  
  1230.      The  outputfiles  (.OUT  and  .ABC)  and  helpfile are normal DOS text
  1231.      files.
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.                              CONTest users manual
  1265.                                    page 21.
  1266.  
  1267.  
  1268.  
  1269.  
  1270.      10 INDEX.
  1271.  
  1272.      Band
  1273.           define for mergefile . . . . . . . . . . . . . . . . . . . . . 18
  1274.           define number of . . . . . . . . . . . . . . . . . . . . . . .  5
  1275.           going to next  . . . . . . . . . . . . . . . . . . . . . .  7, 11
  1276.           going to previous  . . . . . . . . . . . . . . . . . . . .  7, 11
  1277.      Cancel qso  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1278.      Commands
  1279.           <?>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1280.           <C>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1281.           <CE> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1282.           <CLS>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1283.           <D>  . . . . . . . . . . . . . . . . . . . . . . . . . . . 12, 18
  1284.           <DATE> . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1285.           <DX> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1286.           <E>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1287.           <GMT>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1288.           <L>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1289.           <N>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1290.           <P>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1291.           <SC> . . . . . . . . . . . . . . . . . . . . . . . . . . . 11, 18
  1292.           <SQ> . . . . . . . . . . . . . . . . . . . . . . . . . . . 12, 18
  1293.           <TIME> . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1294.           <X>  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1295.      Coversheet
  1296.           modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1297.           specify  . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  1298.      Crossband . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1299.      Datafile
  1300.           current  . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1301.           define names . . . . . . . . . . . . . . . . . . . . . . . . .  5
  1302.      Date
  1303.           display  . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1304.      Distance
  1305.           average  . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1306.           total  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1307.      Edit
  1308.           go to mode . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1309.           mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1310.      Exit
  1311.           logfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  1312.           online mode  . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1313.           program  . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1314.      Gmt
  1315.           display  . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1316.           set  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  1317.      Help
  1318.           online . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1319.      Input
  1320.           automatic  . . . . . . . . . . . . . . . . . . . . . . . . . 8, 9
  1321.           manual . . . . . . . . . . . . . . . . . . . . . . . . . .  8, 10
  1322.      Logfiles
  1323.           create . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  1324.  
  1325.                              CONTest users manual
  1326.                                    page 22.
  1327.  
  1328.  
  1329.  
  1330.  
  1331.           display  . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  1332.           format . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  1333.           going to menu  . . . . . . . . . . . . . . . . . . . . . . . .  7
  1334.           print  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  1335.      Main menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1336.      Mergefile
  1337.           create . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  1338.           define . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  1339.           use of . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  1340.      Online
  1341.           commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1342.           going to mode  . . . . . . . . . . . . . . . . . . . . . . . .  7
  1343.           mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  1344.      Print outputfile
  1345.           Print  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  1346.      Qth locator
  1347.           set own  . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  1348.      Record format
  1349.           coversheetfile . . . . . . . . . . . . . . . . . . . . . . . . 21
  1350.           datafile . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
  1351.           mergefile  . . . . . . . . . . . . . . . . . . . . . . . . . . 20
  1352.           output and helpfiles . . . . . . . . . . . . . . . . . . . . . 21
  1353.      Save
  1354.           qso on disk  . . . . . . . . . . . . . . . . . . . . . . . . .  8
  1355.      Status line . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1356.      Time
  1357.           display  . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.                              CONTest users manual
  1387.                                    page 23.
  1388.